From: Colin Walters <walters@verbum.org>
Date: Tue, 15 Apr 2025 17:53:57 +0000 (-0400)
Subject: prepare-root: Document that /var is unaffected by root.transient
X-Git-Tag: archive/raspbian/2025.7-2+rpi1^2^2~6^2~4^2~39^2
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=cc402a1ea7a38d88bc43b165799e99a0f577743b;p=ostree.git

prepare-root: Document that /var is unaffected by root.transient

Closes: https://github.com/ostreedev/ostree/issues/3409
---

diff --git a/man/ostree-prepare-root.xml b/man/ostree-prepare-root.xml
index c1f39a8a..2067d1cc 100644
--- a/man/ostree-prepare-root.xml
+++ b/man/ostree-prepare-root.xml
@@ -129,7 +129,7 @@ License along with this library. If not, see <https://www.gnu.org/licenses/>.
                    it is supported for example to have <literal>root.transient=true</literal> but <literal>etc.transient=false</literal> in which case changes to <literal>/etc</literal> continue
                    to persist across updates, with the default OSTree 3-way merge applied.
                    Also related to persistence it is important to emphasize that <literal>/sysroot</literal> (the physical root filesystem) is still persistent
-                   by default; in-place OS upgrades can be applied.
+                   by default; in-place OS upgrades can be applied. This option has no effect on <literal>/var</literal>.
                 </para>
                 <para>
                   Enabling this option can make it significantly easier to adopt an image-based model in some circumstances.